home *** CD-ROM | disk | FTP | other *** search
/ A.C.E. 3 / ACE CD 3.iso / files / docs / crossdv6.lha / CrossDosV4.02a.doc < prev    next >
Text File  |  1994-11-27  |  56KB  |  1,464 lines
  1.                             CrossDOS Version 4.02a  
  2.                        Full manual, readme and info etc.
  3.                        
  4.                                  
  5. Brought to you by LSD!                                 
  6.                                  
  7.                               April 2nd, 1991
  8.  
  9. We at CONSULTRON would like to thank you for purchasing CrossDOS.  We
  10. believe you will find it useful as well as easy to use.
  11.  
  12.  
  13. *******************************************
  14. Installing this Product
  15.  
  16. I have included a simple program called "Install_MSDOSFS".  It can be
  17. run  from  the CLI or from Workbench.  It will prompt you through the
  18. installation  procedure.   The  program  is  broken  up into separate
  19. transfer  procedures that allow you to install portions that apply to
  20. your  system configuration.  If you wish, you can install the product
  21. manually  by  placing  the necessary files in the correct directories
  22. (please refer to the manual supplied with CrossDOS).
  23.  
  24. The installation program will try to install the appropriate software
  25. modules   into  your  system  directories  (ie  C:,  L:,  DEVS:   and
  26. SYS:CrossDOS).   If  these directories are located on your hard disk,
  27. it  will  attempt  to  install  them there otherwise it will probably
  28. install them on your WORKBENCH boot-up disk.
  29.  
  30. If    you   install   CrossDOS,   you   may   need   to   edit   your
  31. "S:startup-sequence"  and move the "MountMF" command, appended on the
  32. end of this file, to a position before the "LoadWB" command.
  33.  
  34. For those who either do not have enough room on their system disks or
  35. do  not  wish to install CrossDOS, a small utility called "Attach" is
  36. included  that will allow you to immediately mount and load an MS-DOS
  37. floppy device on your Amiga.  For further information on the "Attach"
  38. command, refer to the manual.
  39.  
  40.  
  41. *******************************************
  42. TDPatch12 and TDPatch13
  43.  
  44. The trackdisk.device code resident in Kickstart code versions 1.2 and
  45. 1.3  has  a  couple  bugs  that  need  fixing as well as adding a new
  46. feature  found  in  version 2.0 of the trackdisk.device.  "TDPatch12"
  47. and  "TDPatch13"  correct  this  problem  for KickStart V1.2 and V1.3
  48. respectively.   The  installation  program will detect the version of
  49. KickStart  you  are  running and transfer the proper patch version to
  50. your  "C:"  directory.  You can either execute this patch manually or
  51. use  the "MountMF" command to execute it.  It MUST be executed before
  52. accessing any MS-DOS disk.
  53.  
  54. For  those  users  with  version  1.2 or 1.3 Kickstart ROMs, you MUST
  55. execute  the  appropriate patch to correctly operate with the current
  56. floppy device driver (mfm.device).
  57.  
  58. TDPatch will not work in conjunction with NOCLICKSTART.
  59.  
  60.  
  61. *******************************************
  62. International Character Translator
  63.  
  64. This  version  of  CrossDOS allows for you to select an International
  65. (Standard  or  Danish)  version  of  the file system.  You can select
  66. either version in the installation program "Install_msdosFS".
  67.  
  68. The standard ASCII character set of MS-DOS matches the standard ASCII
  69. character set of the Amiga one-for-one.  The extended ASCII character
  70. set,  which include international characters, do not match so nicely.
  71. For  those  who  chose  the  International  version,  extended  ASCII
  72. characters  found  in  the  file  names are always converted to their
  73. equivalent  (where  ever possible)  on the opposite system.  Extended
  74. ASCII  characters found inside ASCII text files are not automatically
  75. translated.   To  translate the extended characters within files, you
  76. must  either  specify  the  "International  Translator" character '['
  77. (formerly  the  "High  Bit Filter") within the MS-DOS filename or use
  78. the  global  "International Translator" which operates similar to the
  79. global "TxFilter" function.  Refer to the "IntlTrans" utility located
  80. in the technical reference file called "Tech_Ref".
  81.  
  82.  
  83. *******************************************
  84. Improvements from previous versions of CrossDOS
  85.  
  86. Faster Floppy Device Driver:
  87. We  have provided a new floppy device driver called "mfm.device" that
  88. will  access  floppy data up to two times faster than in the previous
  89. versions  of CrossDOS.  Users with 68000 based Amigas will notice the
  90. two  times  speed  improvement.  Users with 68020, 68030, 68040 based
  91. Amigas  may  not  notice any speed increase because the raw access of
  92. data from the disk is limited by the constant rotational speed of the
  93. disk  (0.2  seconds  for  a  full track) and head stepping time.  All
  94. users  will  actually get about a two-and-a-half times inprovement of
  95. decoding/encoding the raw floppy data which significantly reduces the
  96. CPU processing time.
  97.  
  98. Technical Reference Manual on Disk:
  99. This  product  disk  also has a technical reference file on disk that
  100. covers an example mountlist, a small glossary, and device error codes
  101. supported by CrossDOS.
  102.  
  103. "In Case of Difficulty" on Disk:
  104. Should  you  run  into  any  problems  when  using  CrossDOS, we have
  105. provided  a  file  on disk that contains many of the common (and some
  106. uncommon) problems that may be encountered.  The list represents most
  107. of  the  problems  reported  to our Technical Support staff and their
  108. recommended solutions.
  109.  
  110. "MountMF" command:
  111. We  have provided a new command to replace the cumbersome "Mount" (or
  112. "Mount_JDS")  for "mounting" MS-DOS floppy devices.  "MountMF" can be
  113. run  from  either  the  S:Startup-Sequence,  the  CLI  or  WORKBENCH.
  114. Executing "MountMF" will first execute "TDPatch12" or "TDPatch13" (if
  115. needed)  and  then  will  mount  all the floppy devices found on your
  116. Amiga  system.   This  command  only  mounts  floppy devices but will
  117. replace multiple "Mount" commands as well as the "TDPatch" command in
  118. your  S:Startup-Sequence.  The MS-DOS floppy device names will be the
  119. default DI0:, DI1:, DI2:  and DI3:.
  120.  
  121.  
  122. *******************************************
  123. MS-DOS Hard Disk Partitions
  124.  
  125. The  MS-DOS file system is designed to read and write physical MS-DOS
  126. hard  drive  partitions,  although it has not been tested thoroughly.
  127. Virtual MS-DOS partitions on an Amiga hard drive (such as JLink files
  128. created by the BridgeBoard) are not accessible at this time.
  129.  
  130. We  have  a  few  people currently using this feature.  One person is
  131. accessing  a  MS-DOS  formatted  Bernoulli disk from both his IBM and
  132. Amiga computers.  Others are using MS-DOS foramtted SyQuest removable
  133. to exchange data between the two machines.
  134.  
  135. Contact  us  at  our technical support line for information on how to
  136. construct a custom mountlist entry for MS-DOS hard disk media.
  137.  
  138. The  installation  program  does  not  mount  an  MS-DOS  hard  drive
  139. partition  so  that  creating  a  mountlist entry for it must be done
  140. manually.   An  example of a hard disk mountlist entry is included in
  141. the  file "DEVS/mountlist.msdos" for your review.  You must configure
  142. the  mountlist  entries so that the lowest block number points to the
  143. MS-DOS boot block of the partition you wish to access.  The "device="
  144. parameter  must  also  be  the  device  driver  for  your  hard drive
  145. controller board.
  146.  
  147.  
  148. *******************************************
  149. Undocumented directory (DIAG/)
  150.  
  151. We have added a directory called "DIAG" that is not documented in the
  152. manual.   This  directory  contains files that are used for obtaining
  153. diagnostic  information  should  a problem occur.  Use of these files
  154. without  specific  direction from us is NOT RECOMMENDED.  These files
  155. may  produce  undesirable results if not used properly.  Refrain from
  156. using these files!
  157.  
  158.  
  159. *******************************************
  160. Technical Support
  161.  
  162. Should you have any questions or problems, you can contact us at:
  163.  
  164. CONSULTRON
  165. 11280 Parkview
  166. Plymouth, MI  48170
  167.  
  168. (313) 459-7271      10:00 AM - 5:00 PM EST     Weekdays
  169.  
  170.  
  171. *******************************************
  172. Electronic Bulletin Board Service
  173.  
  174. (313) 459-7271      6:00 PM - 10:00 AM EST      Weekdays
  175.                 all day on weekends
  176.  
  177.  
  178. Thank you.
  179. "In Case of Difficulty"
  180.  
  181. Should  you  experience  some difficulty accessing an MS-DOS
  182. disk,  here  are  some  ideas  that may help narrow down the
  183. problem.
  184.  
  185. First,  make  sure you have configured the drive you wish to
  186. use  the  MS-DOS  disk  on  by  using  either  the "MountMF"
  187. command  or  the  "Attach"  command.   If  you are using the
  188. "Attach"  command,  specify  the  correct device name of the
  189. drive  you  wish to use.  The device names correspond to the
  190. device  names  given  by  Commodore  (ie. DI0: is the MS-DOS
  191. device name whereas DF0: is the AmigaDOS device name).
  192.  
  193. The  easiest  way  check  an  MS-DOS  disk  is  to  run  the
  194. "DiskChk"  program  included with CrossDOS to generate error
  195. numbers that can be used with the following chart.
  196.  
  197.  
  198. Problem/Solution Chart
  199.  
  200. Problem             Solution (or areas to check)
  201. =============================================================
  202. "Not a DOS Disk"    Make sure the disk is an MS-DOS standard
  203.  Requester          density formatted disk.  The disk may be
  204.                     an AmigaDOS or MS-DOS high density
  205.                     formatted disk.
  206.  
  207. "Disk Ejected Too   Disk removed before all information
  208.  Soon" Requester    written to it. Replace disk and retry
  209.                     may recover without corruption.  We
  210.                     recommend you wait at least 3 seconds
  211.                     from the last disk access before removing
  212.                     the disk.
  213.  
  214. "FAT Table Corrupt" Important information on the disk is
  215.  Requester          sensed to be corrupt.  Use a disk salvage
  216.                     program on your MS-DOS computer to try to
  217.                     recover data where possible.
  218.  
  219. "Disk Full"         Exceeded the capacity of the system disk.
  220.  Requester using    Remove unnecessary files from the disk or
  221.  "Install_msdosFS"  use "Attach" command.
  222.  
  223. "Not an MS-DOS      Device name selected does not refer to an
  224.  disk" response     MS-DOS configured device.  Chose the
  225.  from "MFormat"     device name such as DI0: instead of DF0:
  226.  
  227. "DF0:BAD" disk      This is OK.  The task that handles the
  228.  icon               device called DF0: cannot recognize a
  229.                     foreign disk format.
  230.  
  231. Used "MountMF"      "MountMF" only configures all the drives
  232.  from WORKBENCH or  as MS-DOS devices but does not load the
  233.  boot file          file system code to save memory.  Your
  234.  but no icon        first access of the device in a program
  235.  appears            will load the file system and the icon
  236.                     should appear.
  237.  
  238. Copied icon to      Copy only files with NO file extension.
  239.  MS-DOS disk using  WORKBENCH icons already have an extension
  240.  WORKBENCH but      (.info).  MS-DOS file names can only have
  241.  cannot properly    one extension.  Also, avoid file names
  242.  access icon later  longer than 8 characters. Rename files if
  243.  on same disk       they are a problem.
  244.  
  245. Changed the MS-DOS  The 5 1/4" drive does not support the
  246.  disk on the 5 1/4" "diskchange" signal.  When you change
  247.  drive and still    disks, issue the CLI "DiskChange" command
  248.  get the old di-    or our "DiskChg" command on the drive
  249.  rectory from the   before your next access to the new disk.
  250.  previous disk
  251.  
  252. Copied file to      Avoid using spaces in files names.  The
  253.  MS-DOS disk but    MS-DOS computer ignores everything after
  254.  cannot find it     the space character.
  255.  when reading the
  256.  disk on my MS-DOS
  257.  computer
  258.  
  259. Error=-4            TDPatch12 or TDPatch13 needs to be applied.
  260.  
  261. Error=21            Could not find any sectors on the
  262.                     specified track.  Probably not MS-DOS
  263.                     standard density formatted.
  264.  
  265. Error=22            Sector not aligned with index signal
  266.                     from disk.  Usually not disastrous.
  267.                     Retry may recover.
  268.  
  269. Error=23            Sector not found.  Disk may be corrupt.
  270.                     Retry may recover.
  271.  
  272. Error=24            Sector identification info corrupt.
  273.                     Retry may recover.
  274.  
  275. Error=25            Sector data may be corrupt.
  276.                     Retry may recover.
  277.  
  278. Error=38            Index signal from the drive not received.
  279.                     Amiga needs service to correct hardware
  280.                     problem.
  281. ==============================================================
  282.  
  283. If you still have problems, you can call us at:
  284. (313) 459-7271
  285.   Mon-Fri   10:00 AM to 5:00 PM     Eastern Standard Time
  286.  
  287.  
  288. Helpful Tips
  289.  
  290. Here  are some helpful tips to make using CrossDOS as simple
  291. as possible.
  292.  
  293. -  Avoid file names longer than 8 characters.
  294. -  Avoid file extensions longer than 3 characters.
  295. -  Avoid space in file names or file extensions.
  296. -  When  using WORKBENCH, avoid transferring files with file
  297.    extensions.  Rename them first if necessary.
  298. -  Make  sure  the type of file you want to use between both
  299.    the   Amiga   program   and   the   MS-DOS   program  are
  300.    compatible.   Example:  A  Scribble! file is not readable
  301.    by a WordPerfect wordprocessor.
  302. -  Should you exhibit read or write  errors with no specific
  303.    pattern, we suggest  you clean the  floppy drive heads of
  304.    both the Amiga and MS-DOS computers.
  305.  
  306.  
  307. DEVICE ERROR CODES
  308.  
  309. The  following  is  a list of most of the device error codes
  310. supported.
  311.  
  312. Err#    Error Name          Description
  313. ----------------------------------------------------------------
  314. -1    IOERR_OPENFAIL        device/unit failed to open
  315. -2    IOERR_ABORTED         request aborted
  316. -3    IOERR_NOCMD           command not supported
  317. -4    IOERR_BADLENGTH       not a valid length
  318.  
  319. 20    TDERR_NotSpecified    general catchall
  320. 21    TDERR_NoSecHdr        couldn't find any sectors on track
  321. 22    TDERR_BadSecPreamble  bad sector header
  322. 23    TDERR_BadSecID        bad sector header
  323. 24    TDERR_BadHdrSum       sector header had incorrect CRC
  324. 25    TDERR_BadSecSum       data had incorrect CRC
  325. 26    TDERR_TooFewSecs      couldn't find enough sectors
  326. 27    TDERR_BadSecHdr       bad sector header
  327. 28    TDERR_WriteProt       can't write to a protected disk
  328. 29    TDERR_DiskChanged     no disk in the drive
  329. 30    TDERR_SeekError       couldn't find track 0
  330. 31    TDERR_NoMem           ran out of memory
  331. 32    TDERR_BadUnitNum      asked for a unit > 3
  332. 33    TDERR_BadDriveType    not a recognized drive
  333. 34    TDERR_DriveInUse      someone else allocated the drive
  334. 35    TDERR_PostReset       user hit reset; awaiting doom
  335. 36    MDERR_OutofTracks     out of physical tracks
  336. 37    MDERR_InvParam        invalid parameter (MD_SETPARMS)
  337. 38    MDERR_IndexNotSync    index signal not available
  338. 39    MDERR_WrongTrack      drive head on wrong physical track
  339.  
  340.  
  341.                            TABLE OF CONTENTS
  342.  
  343.  
  344.           
  345.  
  346.           1  TECHNICAL SPECIFICATIONS       ....................  1-1
  347.              1.1  L:MSDOSFileSystem        .....................  1-1
  348.              1.2  DEVS:mfm.device        .......................  1-1
  349.  
  350.           2  MountList Example of an MS-DOS device   ...........  2-1
  351.  
  352.           3  GLOSSARY        ...................................  3-1
  353.  
  354.           4  DEVICE ERROR CODES      ...........................  4-1
  355.              4.1  "In Case of Difficulty"     ..................  4-1
  356.                 4.1.1  Problem/Solution Chart       ............  4-1
  357.                 4.1.2  Helpful Tips       ......................  4-3
  358.  
  359.           5  CrossDOS UTILITIES       ..........................  5-1
  360.              5.1  MS-DOS File System Support Utilities    ......  5-1
  361.              5.2  "MountMF"        .............................  5-1
  362.                 5.2.1  "Mount_JDS"        ......................  5-1
  363.                 5.2.2  "Kill"        ...........................  5-2
  364.                 5.2.3  "DiskChk"        ........................  5-3
  365.                 5.2.4  "MFormat"        ........................  5-3
  366.                 5.2.5  "MDiskCopy"        ......................  5-5
  367.                 5.2.6  "Attach"        .........................  5-6
  368.                 5.2.7  "TxFilter"        .......................  5-6
  369.                 5.2.8  "IntlTrans"        ......................  5-7
  370.                 5.2.9  "DiskChg"        ........................  5-8
  371.                 5.2.10  "TDPatch12 or TDPatch13"      ..........  5-8
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.                                                                      I
  400.                                    CrossDOS ... The MS-DOS File System
  401.  
  402.  
  403.           w1    TECHNICAL SPECIFICATIONS       w 
  404.  
  405.           The  following  are the technical specifications of the file
  406.           system and device driver.  
  407.  
  408.           1.1  L:MSDOSFileSystem         
  409.  
  410.           The  Amiga  allows  for  foreign disk formats as well as the
  411.           standard  AmigaDOS  disk  format  to  be  used  by placing a
  412.           common  interface  (DOS  interface)  between the application
  413.           and  the  file system.  The file system code that translates
  414.           the  foreign  disk format must conform to at least a minimum
  415.           set of commands from this DOS interface.  
  416.  
  417.           The  MS-DOS  File  System  code  translates the DOS commands
  418.           into  MS-DOS  disk  format  specific reads and writes to the
  419.           device.   If the device is a floppy disk, the file system is
  420.           initialized  to  open the "mfm.device" to translate raw data
  421.           from  the  disk  into  data  blocks  and  vice versa.  Other
  422.           devices  could  be  used  by  using  the  device driver code
  423.           supplied by the device controller manufacturer.  
  424.  
  425.  
  426.           1.2  DEVS:mfm.device         
  427.  
  428.           The  "mfm.device" is used to decode and encode "mfm" data in
  429.           a  standard  (non-Amiga)  format  on a floppy disk.  It acts
  430.           very  much like the Amiga-supplied "trackdisk.device" device
  431.           driver  code.   It  answers  requests  for drive control and
  432.           blocks of data transfer.  
  433.  
  434.           The  "mfm.device"  responds to all the command types as does
  435.           the "trackdisk.device" with the following exceptions: 
  436.  
  437.             -  EXT (Extended) command qualifiers are not valid.  
  438.  
  439.             -  A  new command MDCMD_SETPARMS = 29 is included to allow
  440.                the  device  driver  to  set  some of the physical disk
  441.                parameters   to   new  values.   The  FileSysStartupMsg
  442.                Environment  Table  pointer is passed in io_Data.
  443.                Any errors are returned in io_Error.
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.                                                                    1-1
  459.                                    CrossDOS ... The MS-DOS File System
  460.  
  461.  
  462.           w2    MountList Example of an MS-DOS device   w 
  463.  
  464.           The  following  is  an example mountlist entry for an MS-DOS
  465.           device  using the internal 3 1/2" drive in the Amiga.  It is
  466.           called  by  the  name DI0: by the system.  Other units
  467.           and  device  names can be used as specified by Amiga "mount"
  468.           command file parameters.  
  469.  
  470.                DI0:
  471.                        /* Device-dependent mountlist parameters */
  472.                    Device = mfm.device
  473.                    Unit   = 0
  474.                    Flags  = 1
  475.                    Surfaces  = 2
  476.                    BlocksPerTrack = 9
  477.                    Reserved = 1
  478.                    Interleave = 0
  479.                    LowCyl = 0  ;  HighCyl = 79
  480.  
  481.                        /* FileSystem-dependent mountlist parameters */
  482.                    FileSystem = L:MSDOSFileSystem
  483.                    Stacksize = 4000
  484.                    Priority = 5
  485.                    GlobVec = -1
  486.                    Buffers = 5
  487.                    BufMemType = 0 
  488.                    Mount = 0
  489.                    DosType = 0x4D534400
  490.                         /* = 0x4D444400  using Double Track Step Mode */
  491.                #
  492.  
  493.  
  494.           NAME: 
  495.              The   name   of   the   device.   It  may  be  any  valid
  496.              alphanumeric  combination  that  does  not  conflict with
  497.              other  device,  volume  or logical names already mounted.
  498.              The  name  must  end  in  a  ":"  to be recognized by the
  499.              "mount" command.  
  500.  
  501.           Device =
  502.              The  name  of  the device driver code file to be used for
  503.              the  particular  device  being  accessed.   When  using a
  504.              floppy  drive  device,  the device driver "mfm.device" is
  505.              included  in this product for this purpose.  Please note:
  506.              the directory "DEVS:" is assumed as the path name.  
  507.  
  508.           Unit = 
  509.              The  physical  unit number of the particular device being
  510.              accessed.   Normally,  Unit  0  is  the  first unit.  For
  511.              Amiga floppy drives, Unit 0 is the internal drive.  
  512.  
  513.           Flags = 
  514.  
  515.  
  516.  
  517.                                                                    2-1
  518.           CrossDOS ... The MS-DOS File System
  519.  
  520.  
  521.              The  flags  needed  to  properly initialize the device at
  522.              startup.   The  flags  to  be  set  will  vary  for  each
  523.              device.   For  the  Amiga  compatible  floppy drives, set
  524.              Flags to '1' (allow 5 1/4" drive).
  525.  
  526.           Surfaces = 
  527.              The  number  of  physical  surfaces  of  the device.  For
  528.              standard  MS-DOS  floppies,  set  this  value  to  2  for
  529.              double-sided.  
  530.  
  531.           BlocksPerTrack = 
  532.              The  number  of  physical  blocks  on  each  track of the
  533.              device.   For standard MS-DOS floppies, set this value to
  534.              9.  
  535.  
  536.           Reserved =
  537.              The  number  of  reserved blocks for the beginning of the
  538.              partition  of  the device.  For standard MS-DOS floppies,
  539.              set this value to 1.  
  540.  
  541.           Interleave = 
  542.              The  physical  interleave  of sectors of the device.  For
  543.              standard MS-DOS floppies, set this value to 0.  
  544.  
  545.           LowCyl = 
  546.              The  physical  low  cylinder  number of the beginning the
  547.              the  device  partition.   To calculate the LowCyl use the
  548.              following formula:  
  549.               
  550.                LowCyl = [BLOCK_beg / (Surfaces * BlocksPerTrack)]
  551.                            (integer part only)
  552.                BLOCK_beg = The beginning block number of the partition
  553.  
  554.                Example =>  0 = [ 0 / (2 * 9)]
  555.                
  556.  
  557.              For  standard  40  or  80  track  floppy drives, set this
  558.              value to 0.  
  559.  
  560.           HighCyl =
  561.              The  physical  high  cylinder  number  of the end the the
  562.              device  partition.   To  calculate  the  HighCyl  use the
  563.              following formula:  
  564.               
  565.                HighCyl = [BLOCK_end / (Surfaces * BlocksPerTrack)]
  566.                            (integer part only)
  567.                BLOCK_end = The end block number of the partition
  568.  
  569.                Example =>  79 = [ 1439 / (2 * 9)]
  570.                
  571.  
  572.              For  standard  80  track floppy drives, set this value to
  573.  
  574.  
  575.  
  576.           2-2
  577.                                    CrossDOS ... The MS-DOS File System
  578.  
  579.  
  580.              79.   For standard 40 track floppy drives, set this value
  581.              to  39.   For  standard  80  track  floppy drives used in
  582.              Double Track Step Mode, set this value to 39.  
  583.  
  584.           FileSystem = 
  585.              The  name of the FileSystem code file to be used to allow
  586.              AmigaDOS  to  access  non-AmigaDOS  formatted disks.  For
  587.              this product, use "L:MSDOSFileSystem".  
  588.  
  589.           Stacksize =
  590.              The  stack  size  needed  for  the file system task.  Use
  591.              4000 bytes or more if desired.  
  592.  
  593.           Priority = 
  594.              The  priority  of  the  file  system  task.  Should be at
  595.              least a priority 5.  Modify if desired.  
  596.  
  597.           GlobVec = 
  598.              The  global  vector  of the file system task.  This value
  599.              MUST be set to -1.  
  600.  
  601.           Buffers = 
  602.              The  number  of  cache  buffers for the file system task.
  603.              Set  to the number of buffers to you desire.  Each buffer
  604.              consumes  about 1040 bytes.  The more buffers, the faster
  605.              the  performance.   Be  aware though, there is a point of
  606.              diminishing returns with more buffers.  
  607.  
  608.              For  normal  sized  directories  a  value of 5 buffers is
  609.              sufficient.    If   large   and/or   multiple  levels  of
  610.              directories  are used (ie. greater than 2), a value of 10
  611.              will   yield   faster  accesses.   The  AmigaDOS  command
  612.              "addbuffers"  will  add  more  buffers to the file system
  613.              cache.  
  614.  
  615.           BufMemType = 
  616.              The  type  of  memory  used  by the cache buffers.  It is
  617.              recommended   to  set  this  value  to  0  or  1  (PUBLIC
  618.              memory).  
  619.  
  620.           Mount = 
  621.              If  this  parameter is positive (>0), the "mount" command
  622.              will   immediately   install   the   file   system  code.
  623.              Otherwise,  the file system will be loaded when the first
  624.              access  to  the  device occurs.  It is recommended to set
  625.              this  value  to 0 or do not include this parameter at all
  626.              so  that  the  memory for the file system and device will
  627.              not be used until needed.  
  628.  
  629.           DosType = 
  630.              This  parameter  indicates  the type of file system used.
  631.              For    floppy    drives,    this    value    should    be
  632.  
  633.  
  634.  
  635.                                                                    2-3
  636.           CrossDOS ... The MS-DOS File System
  637.  
  638.  
  639.              0x4D534400.   For  80  track  5 1/4" drives used in
  640.              the  40 track (double track step) mode, this value should
  641.              be  0x4D444400  (Refer  to section "Double Track
  642.              Step Mode" for further explanation).
  643.  
  644.           # 
  645.              Device  mountlist  terminating character.  This character
  646.              MUST  be present in the first column of new line
  647.              to  terminate  the  mountlist  parameters  for a specific
  648.              device.  
  649.  
  650.                NOTE 
  651.                Parameters  left out of the mountlist for a device, are
  652.                either automatically set to 0 or a default value.  
  653.  
  654.                NOTE 
  655.                Only  one  MS-DOS  File System is allowed to be mounted
  656.                on any one physical device.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.           2-4
  695.                                    CrossDOS ... The MS-DOS File System
  696.  
  697.  
  698.           w3    GLOSSARY        w 
  699.  
  700.           The  following  are  a  small glossary of terms used in this
  701.           manual.  
  702.  
  703.           CLI   -   Command   Line  Interpreter.   A  method  of
  704.           accessing  Amiga  programs  without  using the mouse.  It is
  705.           very flexible means of controlling the Amiga.  
  706.  
  707.           double-click  -  The  action  of  quickly pressing and
  708.           releasing a mouse button (usually the left one) twice.  
  709.  
  710.           extend-select  - The method of selecting more than one
  711.           icon.   In  order  to  use  it, hold down the SHIFT key when
  712.           selecting  and  icon.   When selecting multiple files, order
  713.           of selection is important.
  714.  
  715.           MountList  File  -  This  is a standard text file that
  716.           describes  new  devices  for  the  Amiga operating system to
  717.           use.   Each  device  has its own set of MountList parameters
  718.           that follow its designated name in the file.  
  719.  
  720.           Project  Icon  -  This  is a special icon that calls a
  721.           program  specified  in  the  DEFAULT TOOL parameter and will
  722.           pass  options  listed  in  the  TOOL TYPES parameters of the
  723.           icon file.  
  724.  
  725.           select  -  The  action  of  pressing and releasing the
  726.           left mouse button over the object to be selected.  
  727.  
  728.           TOOL  TYPES  parameters  -  These parameters are found
  729.           (and    can   be   modified)   from   WORKBENCH   when   the
  730.           "Project/Info"  menu  item is selected for the icon you wish
  731.           to view/modify.
  732.  
  733.           WORKBENCH   -   The   standard  Amiga  graphical  user
  734.           interface  that  uses  icons  to  access  programs  and data
  735.           files.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.                                                                    3-1
  754.                                    CrossDOS ... The MS-DOS File System
  755.  
  756.  
  757.           w4    DEVICE ERROR CODES      w 
  758.  
  759.           The  following  is  a list of most of the device error codes
  760.           supported.  
  761.  
  762.           Err#    Error Name          Description
  763.           ----------------------------------------------------------------
  764.           -1    IOERR_OPENFAIL        device/unit failed to open  
  765.           -2    IOERR_ABORTED         request aborted
  766.           -3    IOERR_NOCMD           command not supported
  767.           -4    IOERR_BADLENGTH       not a valid length
  768.  
  769.           20    TDERR_NotSpecified    general catchall
  770.           21    TDERR_NoSecHdr        couldn't find any sectors on track
  771.           22    TDERR_BadSecPreamble  bad sector header
  772.           23    TDERR_BadSecID        bad sector header
  773.           24    TDERR_BadHdrSum       sector header had incorrect CRC
  774.           25    TDERR_BadSecSum       data had incorrect CRC
  775.           26    TDERR_TooFewSecs      couldn't find enough sectors
  776.           27    TDERR_BadSecHdr       bad sector header
  777.           28    TDERR_WriteProt       can't write to a protected disk
  778.           29    TDERR_DiskChanged     no disk in the drive
  779.           30    TDERR_SeekError       couldn't find track 0
  780.           31    TDERR_NoMem           ran out of memory
  781.           32    TDERR_BadUnitNum      asked for a unit > 3
  782.           33    TDERR_BadDriveType    not a recognized drive
  783.           34    TDERR_DriveInUse      someone else allocated the drive
  784.           35    TDERR_PostReset       user hit reset; awaiting doom
  785.           36    MDERR_OutofTracks     out of physical tracks
  786.           37    MDERR_InvParam        invalid parameter (MD_SETPARMS)
  787.           38    MDERR_IndexNotSync    index signal not available
  788.           39    MDERR_WrongTrack      drive head on wrong physical track
  789.  
  790.           4.1  "In Case of Difficulty"      
  791.  
  792.           Should  you  experience  some difficulty accessing an MS-DOS
  793.           disk,  here  are  some  ideas  that may help narrow down the
  794.           problem.  
  795.  
  796.           First,  make  sure you have configured the drive you wish to
  797.           use  the  MS-DOS  disk  on  by  using  either  the "MountMF"
  798.           command  or  the  "Attach"  command.   If  you are using the
  799.           "Attach"  command,  specify  the  correct device name of the
  800.           drive  you  wish to use.  The device names correspond to the
  801.           device  names  given  by  Commodore  (ie. DI0: is the MS-DOS
  802.           device name whereas DF0: is the AmigaDOS device name).
  803.  
  804.           The  easiest  way  check  an  MS-DOS  disk  is  to  run  the
  805.           "DiskChk"  program  included with CrossDOS to generate error
  806.           numbers that can be used with the following chart.  
  807.  
  808.           4.1.1  Problem/Solution Chart        
  809.  
  810.  
  811.  
  812.                                                                    4-1
  813.           CrossDOS ... The MS-DOS File System
  814.  
  815.  
  816.           Problem             Solution (or areas to check)
  817.           =============================================================
  818.           "Not a DOS Disk"    Make sure the disk is an MS-DOS standard
  819.            Requester          density formatted disk.  The disk may be
  820.                               an AmigaDOS or MS-DOS high density
  821.                               formatted disk.
  822.  
  823.           "Disk Ejected Too   Disk removed before all information
  824.            Soon" Requester    written to it. Replace disk and retry
  825.                               may recover without corruption.  We
  826.                               recommend you wait at least 3 seconds
  827.                               from the last disk access before removing
  828.                               the disk.
  829.  
  830.           "FAT Table Corrupt" Important information on the disk is
  831.            Requester          sensed to be corrupt.  Use a disk salvage
  832.                               program on your MS-DOS computer to try to
  833.                               recover data where possible.
  834.  
  835.           "Disk Full"         Exceeded the capacity of the system disk.
  836.            Requester using    Remove unnecessary files from the disk or
  837.            "Install_msdosFS"  use "Attach" command.
  838.  
  839.           "Not an MS-DOS      Device name selected does not refer to an
  840.            disk" response     MS-DOS configured device.  Chose the
  841.            from "MFormat"     device name such as DI0: instead of DF0:
  842.  
  843.           "DF0:BAD" disk      This is OK.  The task that handles the
  844.            icon               device called DF0: cannot recognize a
  845.                               foreign disk format.
  846.  
  847.           Used "MountMF"      "MountMF" only configures all the drives
  848.            from WORKBENCH or  as MS-DOS devices but does not load the
  849.            boot file          file system code to save memory.  Your
  850.            but no icon        first access of the device in a program
  851.            appears            will load the file system and the icon
  852.                               should appear.
  853.  
  854.           Copied icon to      Copy only files with NO file extension.
  855.            MS-DOS disk using  WORKBENCH icons already have an extension
  856.            WORKBENCH but      (.info).  MS-DOS file names can only have
  857.            cannot properly    one extension.  Also, avoid file names
  858.            access icon later  longer than 8 characters. Rename files if
  859.            on same disk       they are a problem. 
  860.  
  861.           Changed the MS-DOS  The 5 1/4" drive does not support the
  862.            disk on the 5 1/4" "diskchange" signal.  When you change
  863.            drive and still    disks, issue the CLI "DiskChange" command
  864.            get the old di-    or our "DiskChg" command on the drive
  865.            rectory from the   before your next access to the new disk. 
  866.            previous disk
  867.  
  868.  
  869.  
  870.  
  871.           4-2
  872.                                    CrossDOS ... The MS-DOS File System
  873.  
  874.  
  875.           Copied file to      Avoid using spaces in files names.  The
  876.            MS-DOS disk but    MS-DOS computer ignores everything after
  877.            cannot find it     the space character.
  878.            when reading the
  879.            disk on my MS-DOS
  880.            computer
  881.  
  882.           Error=-4            TDPatch12 or TDPatch13 needs to be applied.
  883.  
  884.           Error=21            Could not find any sectors on the
  885.                               specified track.  Probably not MS-DOS
  886.                               standard density formatted.
  887.  
  888.           Error=22            Sector not aligned with index signal
  889.                               from disk.  Usually not disastrous.
  890.                               Retry may recover.
  891.  
  892.           Error=23            Sector not found.  Disk may be corrupt.
  893.                               Retry may recover.
  894.  
  895.           Error=24            Sector identification info corrupt.
  896.                               Retry may recover.
  897.  
  898.           Error=25            Sector data may be corrupt.
  899.                               Retry may recover.
  900.  
  901.           Error=38            Index signal from the drive not received.
  902.                               Amiga needs service to correct hardware
  903.                               problem.
  904.           ==============================================================
  905.  
  906.           If you still have problems, you can call us at:
  907.           (313) 459-7271
  908.             Mon-Fri   10:00 AM to 5:00 PM     Eastern Standard Time
  909.  
  910.  
  911.           4.1.2  Helpful Tips        
  912.  
  913.           Here  are some helpful tips to make using CrossDOS as simple
  914.           as possible.  
  915.  
  916.           -  Avoid file names longer than 8 characters.  
  917.           -  Avoid file extensions longer than 3 characters.  
  918.           -  Avoid space in file names or file extensions.  
  919.           -  When  using WORKBENCH, avoid transferring files with file
  920.              extensions.  Rename them first if necessary.  
  921.           -  Make  sure  the type of file you want to use between both
  922.              the   Amiga   program   and   the   MS-DOS   program  are
  923.              compatible.   Example:  A  Scribble! file is not readable
  924.              by a WordPerfect wordprocessor.
  925.           -  Should you exhibit read or write  errors with no specific
  926.              pattern, we suggest  you clean the  floppy drive heads of
  927.              both the Amiga and MS-DOS computers.
  928.  
  929.  
  930.                                                                    4-3
  931.                                    CrossDOS ... The MS-DOS File System
  932.  
  933.  
  934.              w5    CrossDOS UTILITIES       w 
  935.  
  936.           The  following  is a description of utilities to enhance the
  937.           usage of CrossDOS.  
  938.  
  939.           5.1  MS-DOS File System Support Utilities     
  940.  
  941.           The  following  utilities  are included with this product to
  942.           enhance  your usage of CrossDOS.  These utilities can be run
  943.           from the CLI or from WORKBENCH.
  944.  
  945.           5.2  "MountMF"        
  946.  
  947.           Format:   MountMF [devicename_prefix]
  948.           Template: MountMF "DEVICENAME_PREFIX/A" 
  949.           Purpose:  To "mount" all MS-DOS floppy devices.
  950.           Path:     MSDOS_FileSystem:MountMF
  951.           Specification:
  952.  
  953.           This  utility  attempts to "mount" all MS-DOS floppy devices
  954.           connected  to  the Amiga.  This utility can be executed from
  955.           WORKBENCH,  the  CLI or your startup-sequence.  Placing this
  956.           command    before    the    "LoadWB"    command    in   your
  957.           startup-sequence   seems  to  provide  the  most  convenient
  958.           results.  
  959.  
  960.           The  following is an example when using the command from the
  961.           CLI:
  962.            
  963.                MSDOS_FileSystem:MountMF
  964.                
  965.  
  966.           To  MountMF  a  device  from  WORKBENCH, double-click on the
  967.           MountMF icon.  
  968.  
  969.           The  DEVICENAME_PREFIX  option  is  available  as TOOL TYPES
  970.           parameter in the project icons.  
  971.  
  972.           MountMF   automatically  executes  the  TDPatch  command  if
  973.           needed.  
  974.  
  975.                NOTE 
  976.                If  your  system is using either Kickstart V1.2 or V1.3
  977.                ROMs,  you  MUST make sure that the appropriate TDPatch
  978.                (TDPatch12  or  TDPatch13)  is  installed  in  your  C:
  979.                directory for this command to work.
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.                                                                    5-1
  990.           CrossDOS ... The MS-DOS File System
  991.  
  992.  
  993.           5.2.1  "Mount_JDS"         
  994.  
  995.           Format:   Mount_JDS <devicename> [FROM <file>]
  996.           Template: Mount_JDS "DEVICENAME/A,FROM/K"
  997.           Purpose:  To create an AmigaDOS device node.
  998.           Path:     C:Mount_JDS
  999.           Specification:
  1000.  
  1001.           This  utility  attempts  to  create an AmigaDOS device node.
  1002.           In   other  words,  Mount_JDS  informs  the  Amiga  that  an
  1003.           additional  device  has  been added to the system.  When the
  1004.           Mount_JDS   command   is  issued,  Mount_JDS  looks  in  the
  1005.           DEVS:MountList  file  (or  the  optional  FROM file) for the
  1006.           parameters  of  the  device  that  is  being  mounted.  This
  1007.           utility  is  only  needed  if you do not already have a V1.3
  1008.           compatible "mount" command.  
  1009.  
  1010.           The  following is an example when using the command from the
  1011.           CLI: 
  1012.            
  1013.                Mount_JDS DI0: FROM DEVS:mountlist.msdosFS
  1014.                
  1015.  
  1016.           To  mount  a  device  from  WORKBENCH,  double-click  on the
  1017.           Mount_JDS.<device> icon (such as "Mount_JDS.DI0").  
  1018.  
  1019.           The  FROM,  and  DEVICENAME  options  are  available as TOOL
  1020.           TYPES  parameters  in  the  project  icons.   Refer  to  the
  1021.           project  icons  supplied with this product for the format of
  1022.           these parameters.  
  1023.  
  1024.  
  1025.           5.2.2  "Kill"         
  1026.  
  1027.           Format:   Kill <devicename>
  1028.           Template: Kill "DEVICENAME"
  1029.           Purpose:  To remove a file system and free resources
  1030.           Path:     C:Kill
  1031.           Specification:
  1032.  
  1033.           This  utility  attempts  to Kill the MS-DOS File System that
  1034.           is  loaded.   It  will  try  to return all the resources and
  1035.           memory allocated.  
  1036.  
  1037.           The  following is an example when using the command from the
  1038.           CLI: 
  1039.            
  1040.                Kill DI0:
  1041.                
  1042.  
  1043.           To    execute    from   WORKBENCH,   double-click   on   the
  1044.           Kill.<device>  icon  (such  as  Kill.DI0) or double-click on
  1045.  
  1046.  
  1047.  
  1048.           5-2
  1049.                                    CrossDOS ... The MS-DOS File System
  1050.  
  1051.  
  1052.           the  Kill  icon and the program will prompt you to enter the
  1053.           name of the device to Kill.  
  1054.  
  1055.           Caution  must  be  exercised  in using this command since it
  1056.           does  not check to make sure all the file locks are returned
  1057.           to  the  file system before Killing it.  If file locks still
  1058.           exist  after  Killing  the  file system, any use of the lock
  1059.           may crash the system.  
  1060.  
  1061.           Using  this  utility  when  WORKBENCH  is running may "hang"
  1062.           WORKBENCH.   To  recover  from  a  hung  WORKBENCH,  issue a
  1063.           "LoadWB" command from a CLI again.  
  1064.  
  1065.           Kill  may  work  with  other  file  systems  but  we  do not
  1066.           guarantee the results.  
  1067.  
  1068.  
  1069.           5.2.3  "DiskChk"        
  1070.  
  1071.           Format:   DiskChk <devicename>
  1072.           Template: DiskChk "DEVICENAME"
  1073.           Purpose:  To check the read integrity of any disk
  1074.           Path:     SYS:System/DiskChk
  1075.           Specification:
  1076.  
  1077.           This  utility  attempts  to  check  the read validity of any
  1078.           disk and report any errors.  
  1079.  
  1080.           The  following is an example when using the command from the
  1081.           CLI: 
  1082.            
  1083.                DiskChk DI0:
  1084.                
  1085.  
  1086.           It  will interactively ask which blocks to check ( lower and
  1087.           upper  limits).   If  the  character  "r" is place after the
  1088.           upper   limit  value  entered,  DiskChk  will  "repeat"  the
  1089.           checking until a Control-C is typed.  
  1090.  
  1091.           This   utility  was  originally  designed  to  check  MS-DOS
  1092.           formatted  disks  but  it should work on any disk mounted on
  1093.           the Amiga.  
  1094.  
  1095.           To  check  disks  from  WORKBENCH, select the desired MS-DOS
  1096.           disk  icon  then  (with  shift key held) double-click on the
  1097.           DiskChk icon.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.                                                                    5-3
  1108.           CrossDOS ... The MS-DOS File System
  1109.  
  1110.  
  1111.           5.2.4  "MFormat"         
  1112.  
  1113.           Format:   MFormat DRIVE <devicename> NAME <diskname> [QUICK]
  1114.                            [NOVERIFY] [FAST] [FMT=MQD9|MD9|MS9|AD9|AS9]
  1115.           Template: MFormat "DEVICENAME,DISKNAME,QUICK/S,NOVERIFY/S,
  1116.                            FMT/K"
  1117.           Purpose:  Format a disk using an MS-DOS format
  1118.           Path:     SYS:System/MFormat
  1119.           Specification:
  1120.  
  1121.           This  utility will format a disk an MS-DOS format using some
  1122.           of  the  parameters  in  the  mountlist  or an explicit disk
  1123.           format (FMT=).  
  1124.  
  1125.           The  QUICK  option  will  only  reformat an MS-DOS disk that
  1126.           previously  had  the same format.  It will supply a new boot
  1127.           block,  file  allocation  tables and the root directory with
  1128.           the volume name as the only entry.  
  1129.  
  1130.           The   NOVERIFY  option  will  not  perform  a  verify  after
  1131.           formatting  a  cylinder.   Using  this option will perform a
  1132.           quicker  physical  format of the disk but the resulting disk
  1133.           is  not  checked for errors.  The QUICK option overrides the
  1134.           NOVERIFY option.  
  1135.  
  1136.           The  FAST  option  is  faster  than  the NOVERIFY option and
  1137.           consequently  checks even less of the format integrity.  The
  1138.           QUICK option overrides the FAST option.
  1139.  
  1140.           The  FMT  option allows another format to be used instead of
  1141.           the   default   format  resulting  from  parameters  in  the
  1142.           mountlist  for the device.  Only one format specification is
  1143.           allowed after the FMT keyword.  
  1144.  
  1145.           The  following is an example when using the command from the
  1146.           CLI: 
  1147.            
  1148.                MFormat DRIVE DI0: NAME "MSDOS_DISK" NOVERIFY FMT=MQD9
  1149.                
  1150.  
  1151.           The  following  table  lists the important parameters of the
  1152.           supported disk formats.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.           5-4
  1167.                                    CrossDOS ... The MS-DOS File System
  1168.  
  1169.  
  1170.           Format| Format| *Num | Num | Secs | Bytes | **Max | Drive
  1171.            Name |  Type | Trks |Sides| /Trk | /Disk |  RDE  | Type
  1172.           ------+-------+------+-----+------+-------+-------+------
  1173.            MQD9 | MSDOS |  80  |  2  |   9  |  720K |  112  | 3 1/2
  1174.            MD9  | MSDOS |  40  |  2  |   9  |  360K |  112  | 5 1/4
  1175.            MS9  | MSDOS |  40  |  1  |   9  |  180K |   64  | 5 1/4
  1176.            AD9  | ATARI |  80  |  2  |   9  |  720K |  112  | 3 1/2
  1177.            AS9  | ATARI |  80  |  1  |   9  |  360K |  112  | 3 1/2
  1178.  
  1179.           *  80 track formats not allowed on 40 track, 5 1/4" drives.
  1180.           ** RDE = root directory entries. One root directory entry
  1181.               is used for the volume name.
  1182.  
  1183.           To  format a default disk from WORKBENCH, select the desired
  1184.           MS-DOS  disk icon then (with shift key held) double-click on
  1185.           the  MFormat  icon.   If  no  MS-DOS disk icon is available,
  1186.           just  double-click on the MFormat icon.  It will then prompt
  1187.           you for the name of the mounted MS-DOS device to format.  
  1188.  
  1189.           If  you wish to specify a format other than the default from
  1190.           WORKBENCH,    select  the  desired  MS-DOS  disk  icon  then
  1191.           double-click  on  the  project  icon with the desired format
  1192.           type (such as "MSDOS_D9.MFormat").  
  1193.  
  1194.           The  FMT,  QUICK, FAST and NOVERIFY options are available as
  1195.           TOOL TYPES parameters in the project icons.  
  1196.  
  1197.  
  1198.           5.2.5  "MDiskCopy"         
  1199.  
  1200.           Format:   MDiskCopy [FROM] <SRCdsk> TO <DSTdsk>
  1201.           Template: MDiskCopy "SRCDISK,DSTDISK"
  1202.           Purpose:  Make a copy of an MS-DOS disk
  1203.           Path:     SYS:System/MDiskCopy
  1204.           Specification:
  1205.  
  1206.           This  utility  will make a copy of an MS-DOS disk on another
  1207.           mounted   MS-DOS   drive.    MDiskCopy   will   not  perform
  1208.           single-drive copies.  
  1209.  
  1210.           The  following is an example when using the command from the
  1211.           CLI:
  1212.            
  1213.                MDiskCopy DI0: TO DI1:
  1214.                
  1215.  
  1216.           To  copy  disks  from  WORKBENCH,  select the desired source
  1217.           MS-DOS  disk icon first, extend-select (with shift key held)
  1218.           the  destination MS-DOS disk icon next, then (with shift key
  1219.           still held) double-click on the MDiskCopy icon.  
  1220.  
  1221.           If   the   MS-DOS   disk   icons  are  not  displayed,  just
  1222.  
  1223.  
  1224.  
  1225.                                                                    5-5
  1226.           CrossDOS ... The MS-DOS File System
  1227.  
  1228.  
  1229.           double-click  on  the  MDiskCopy  icon  and the program will
  1230.           prompt  you  for  the names of the mounted MS-DOS devices to
  1231.           copy.  
  1232.  
  1233.  
  1234.           5.2.6  "Attach"         
  1235.  
  1236.           Format:   Attach <devicename>
  1237.           Template: Attach "DEVICENAME/A" 
  1238.           Purpose:  To "mount" and "load" an MS-DOS device.
  1239.           Path:     MSDOS_FileSystem:Attach
  1240.           Specification:
  1241.  
  1242.           This  utility  attempts  to  "mount"  and  "load"  an MS-DOS
  1243.           device.   This  utility will only work with the installation
  1244.           disk supplied (see NOTE).
  1245.  
  1246.           The  following is an example when using the command from the
  1247.           CLI: 
  1248.            
  1249.                MSDOS_FileSystem:Attach DI0:
  1250.                
  1251.  
  1252.           To  Attach  a  device  from  WORKBENCH,  double-click on the
  1253.           Attach.<device>  icon (such as "Attach.DI0") or double-click
  1254.           on  the  Attach icon and the program will prompt you for the
  1255.           name of the mounted MS-DOS device.  
  1256.  
  1257.           The  DEVICENAME  option is available as TOOL TYPES parameter
  1258.           in the project icons.  
  1259.  
  1260.           Attach   automatically   executes  the  TDPatch  command  if
  1261.           needed.  
  1262.  
  1263.                NOTE 
  1264.                Please   use  a  copy  of  the  original  product  disk
  1265.                supplied.   You  can  add files to it but do not modify
  1266.                any of the files currently on the disk.  
  1267.  
  1268.  
  1269.           5.2.7  "TxFilter"         
  1270.  
  1271.           Format:   TxFilter <devicename> [ON|OFF]
  1272.           Template: TxFilter "DEVICENAME/A,ON/S,OFF/S" 
  1273.           Purpose:  To apply a CTRL-M and CTRL-Z filter on all files
  1274.                          transferred to and from the specified device.
  1275.           Path:     SYS:System/TxFilter
  1276.           Specification:
  1277.  
  1278.           This  utility  attempts  to apply a CTRL-M and CTRL-Z filter
  1279.           on  ALL  files transferred to and from the specified device.
  1280.           This  utility  is  equivalent  to  using the  "CTRL-M/CTRL-Z
  1281.  
  1282.  
  1283.  
  1284.           5-6
  1285.                                    CrossDOS ... The MS-DOS File System
  1286.  
  1287.  
  1288.           Filter" character ']' within all MS-DOS filenames.  
  1289.  
  1290.           The  program  opens  a  window  with  a  small button gadget
  1291.           indicating  the  current  status  of the text filter for the
  1292.           device.   To  toggle  the  filter  into  the opposite state,
  1293.           select   button  gadget.   To  completely  remove  the  text
  1294.           filter,  select the close gadget in the upper left corner of
  1295.           the window.  
  1296.  
  1297.           The  following is an example when using the command from the
  1298.           CLI: 
  1299.           
  1300.                TxFilter DI0:
  1301.                
  1302.  
  1303.           If  the option of ON or OFF is not specified, the default is
  1304.           OFF.  
  1305.  
  1306.           To  TxFilter  a  device  from WORKBENCH, double-click on the
  1307.           TxFilter.<device>   icon   (such   as   "TxFilter.DI0")   or
  1308.           double-click  on  the  TxFilter  icon  and  the program will
  1309.           prompt you for the name of the mounted MS-DOS device.  
  1310.  
  1311.           The  DEVICENAME  option is available as TOOL TYPES parameter
  1312.           in the project icons.  
  1313.  
  1314.  
  1315.           5.2.8  "IntlTrans"        
  1316.  
  1317.           Format:   IntlTrans <devicename> [ON|OFF]
  1318.           Template: IntlTrans "DEVICENAME/A,ON/S,OFF/S" 
  1319.           Purpose:  To apply an International translation on all files
  1320.                          transferred to and from the specified device.
  1321.           Path:     SYS:System/IntlTrans
  1322.           Specification:
  1323.  
  1324.           This  utility attempts to apply an International translation
  1325.           on  ALL  files transferred to and from the specified device.
  1326.           This  utility  is  equivalent  to  using the  "International
  1327.           Translator"   character   '['  (formerly   the   "High   Bit
  1328.           Filter")  within  all  MS-DOS filenames.  This function will
  1329.           ONLY  work when the International version of the file system
  1330.           "MSDOSFileSystem.INTL" is used.  
  1331.  
  1332.           The  program  opens  a  window  with  a  small button gadget
  1333.           indicating  the  current  status  of  the translator for the
  1334.           device.   To  toggle the translator into the opposite state,
  1335.           select  button gadget.  To completely remove the translator,
  1336.           select  the  close  gadget  in  the upper left corner of the
  1337.           window.  
  1338.  
  1339.           The  following is an example when using the command from the
  1340.  
  1341.  
  1342.  
  1343.                                                                    5-7
  1344.           CrossDOS ... The MS-DOS File System
  1345.  
  1346.  
  1347.           CLI: 
  1348.            
  1349.                IntlTrans DI0:
  1350.                
  1351.  
  1352.           If  the option of ON or OFF is not specified, the default is
  1353.           OFF.  
  1354.  
  1355.           To  IntlTrans  a  device from WORKBENCH, double-click on the
  1356.           IntlTrans  icon and the program will prompt you for the name
  1357.           of  the  mounted  MS-DOS  device.   You may use the TxFilter
  1358.           utility to do the same thing.  
  1359.  
  1360.  
  1361.           5.2.9  "DiskChg"         
  1362.  
  1363.           Format:   DiskChg <devicename>
  1364.           Template: DiskChg "DEVICENAME/A" 
  1365.           Purpose:  To force a "diskchange" on the specified device.
  1366.           Path:     SYS:System/DiskChg
  1367.           Specification:
  1368.  
  1369.           This   utility   forces  a  "diskchange"  on  the  specified
  1370.           device.   This command is useful for forcing a diskchange on
  1371.           5  1/4"  floppy drives because they do not have the hardware
  1372.           to  support automatic diskchanges.  This command can also be
  1373.           used on any disk device including hard drives.  
  1374.  
  1375.           The  following is an example when using the command from the
  1376.           CLI: 
  1377.            
  1378.                DiskChg DI0:
  1379.                
  1380.  
  1381.           To  DiskChg  a  device  from  WORKBENCH, double-click on the
  1382.           DiskChg.<device>    icon    (such   as   "DiskChg.DI0")   or
  1383.           double-click  on  the  DiskChg  icon  and  the  program will
  1384.           prompt you for the name of the mounted MS-DOS device.  
  1385.  
  1386.           The  DEVICENAME  option is available as TOOL TYPES parameter
  1387.           in the project icons.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.           5-8
  1403.                                    CrossDOS ... The MS-DOS File System
  1404.  
  1405.  
  1406.           5.2.10  "TDPatch12 or TDPatch13"       
  1407.  
  1408.           Format:   TDPatch12 or TDPatch13
  1409.           Template: TDPatch12 or TDPatch13
  1410.           Purpose:  Patch the trackdisk.device for V1.2 or V1.3 ROMs
  1411.           Path:     C:TDPatch12 or TDPatch13
  1412.           Specification:
  1413.  
  1414.           TDPatch12  or TDPatch13 will patch the trackdisk.device code
  1415.           for  Kickstart  ROMs  V1.2 or V1.3 respectively.  This patch
  1416.           is  needed  because  of  a couple bugs in the trackdisk code
  1417.           supplied   by   Commodore   that   are   not   patched  with
  1418.           "SetPatch".   The  patch  also  supplies  a  feature  in the
  1419.           trackdisk  code that is found in V2.0 Kickstart ROMs but not
  1420.           in  the eariler versions.  This feature is needed to provide
  1421.           CrossDOS with faster floppy data access.
  1422.  
  1423.           The  installation program will detect your Kickstart version
  1424.           and install the proper patch command to your system disk.  
  1425.  
  1426.           This   patch   will   be  automatically  executed  with  the
  1427.           "MountMF"  and  "Attach"  commands.   CrossDOS WILL NOT work
  1428.           with  floppies  if  this patch is not applied for users with
  1429.           V1.2 and V1.3 ROMs 
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.                                                                    5-9
  1462.  
  1463.  
  1464.